Ferramenta: Banco de dados
A ferramenta Banco de dados (database) executa uma consulta SQL fixa em um banco externo sempre que o agente decide usá-la — útil para consultar um catálogo, um cadastro de clientes ou qualquer dado que já vive em outro sistema.
Configuração
| Campo | Descrição |
|---|---|
| Driver | MySQL, PostgreSQL ou SQL Server. |
| Host / Porta / Banco | Dados de conexão com o banco externo. |
| Usuário / Senha | Credenciais de acesso. A senha é armazenada de forma criptografada. |
| Consulta (SQL) | A query executada sempre exatamente como escrita — sem parâmetros. |
Como funciona
O agente não fornece nenhum dado para a consulta — ele apenas decide quando acionar a ferramenta. A query configurada é executada sempre igual, sem receber parâmetros vindos da conversa, e o retorno é limitado a 50 linhas, mesmo que a consulta traga mais resultados.
Como o texto da conversa nunca entra na query, não existe risco de injeção de SQL vindo do lado do agente — a única forma de alterar o comportamento é editando a consulta no cadastro da ferramenta.
Uma ferramenta por consulta Se você precisa consultar informações diferentes dependendo do contexto (ex: buscar por nome ou por CPF), crie uma ferramenta de banco de dados separada para cada consulta, já que não há parametrização.